3D Graphics Programming with QuickDraw 3D 1.5.4

Creating and Deleting Draw Contexts

QuickDraw 3D RAVE provides routines that you can use to create and delete draw contexts.

QADrawContextNew

You can use the QADrawContextNew function to create a new draw context.



 
TQAError QADrawContextNew (

                     const TQADevice *device, 

                     const TQARect *rect, 

                     const TQAClip *clip, 

                     const TQAEngine *engine, 

                     unsigned long flags, 

                     TQADrawContext **newDrawContext);

device: A device.
rect: The rectangular region (specified in device coordinates) of the specified device that can be drawn into by the drawing engine associated with the new draw context.
clip: The two-dimensional clipping region for the new draw context, or NULL if no clipping is desired. This parameter must be set to NULL for devices of type kQADeviceMemory .
engine: A drawing engine.
flags: A set of bit flags specifying features of the new draw context. See "Draw Context Flags Masks" for complete information.
newDrawContext: On entry, the address of a pointer variable. On exit, that variable points to a new draw context. If a new draw context cannot be created, *newDrawContext is set to the value NULL .

DESCRIPTION

The QADrawContextNew function returns, through the newDrawContext parameter, a new draw context associated with the device specified by the device parameter and the drawing engine specified by the engine parameter.

QADrawContextDelete

You can use the QADrawContextDelete function to delete a draw context.



 
void QADrawContextDelete (TQADrawContext *drawContext);

drawContext: A draw context.

DESCRIPTION

The QADrawContextDelete function deletes the draw context specified by the drawContext parameter. Any memory and other resources associated with that draw context are released.